Repository navigation
docs: document saved Photo selections and optional approval - #599
Conversation
| ### 批准、合入和异常恢复 | ||
|
|
||
| 工作流识别具有仓库 Maintain/Admin 权限的维护者对**当前提交**作出的有效 GitHub Approve,该批准同时表示已人工核查 Photo。Bot 不自动 Approve/Merge;GitHub 分支保护和其他检查仍适用,工作流不新增强制 Checks 或修改仓库规则。 | ||
| 工作流中的 GitHub Approve 仅作审计;维护者核对当前提交的 CR、单测、Playwright 和 Photo 后,可以直接手动 Merge。GitHub 分支保护或仓库评审要求仍然适用,Bot 不会修改这些规则,也不会代为 Approve 或 Merge。 |
There was a problem hiding this comment.
[P2] 同步可选批准后的状态与版本操作指引
对已启用图文选择、且仓库规则允许直接合入的 PR,这里允许维护者核查后不作 Approve 就 Merge;但同页状态表仍写“等待人工合入”须识别当前提交的有效批准,第 72 行仍写新提交需要有效批准,英文版也保留相同要求。维护者按状态表处理时会继续等待或请求一次不再必要的批准,也无法据此判断当前版本何时可合入。请为可选批准的 PR 明确状态与新提交处理方式,并同步两种语言的操作指引。
已确认修复 (4019e28): 已复查原触发条件:允许不作 GitHub Approve 而手动合入的流程下,中英文状态表的“等待人工合入”现均要求核对三项建议、Photo 和保存修订,不再要求识别当前提交的有效批准;两版新提交指引也改为重新核对当前结果与保存修订。原先会让维护者继续等待批准的文档冲突已消失,仓库评审规则的适用边界仍被保留。
| Photo 自动差异评估及标准图自动更新暂停。Approve/Merge 不授权自动采用测试图;提前合入不会使未完成或失败的检查变为通过。新增/修改共享基准需管理员另行获得明确授权、人工核查并安排复验,原报告保留。 | ||
| 对已明确启用图文选择的 PR,BugServer 展示当前版本的图片和短说明,新候选默认全选。维护者应逐项核查;需要保留旧基准的项目取消选择,并在合入前保存成功。以服务端显示的保存修订为准,未保存草稿不生效;已保存的人工选择不会被默认全选覆盖。 | ||
|
|
||
| 合入后只更新该修订已选的基准,未选项不变。写入前仍核对冻结提交、三项检查、实际合入内容、保存时间及原基准;旧版本、合入后补选或冲突不能自动补认。请求超时或部分成功时联系维护者按原任务恢复,不重新派发或更换请求 ID。 |
There was a problem hiding this comment.
[P2] 为图文选择模式更新仍要求手工写入基准的指南
已启用图文选择的 PR 在合入前保存修订后,这里明确说工作流只更新所选基准;但同仓 packages/vseed/__tests__/visual/BUGSERVER_CASE_WORKFLOW.md 第 29–33 行仍无条件要求管理员另行取得授权、手工更新并安排新的 Photo 复验,还写明“工作流不自动建立或更新基准”;PR 模板也写“不自动…更新基准”。维护者从视觉指南进入该流程时可能在工作流写入后重复操作共享基准,或将正常更新误判为不应发生。请给旧流程及模板增加图文选择模式的适用边界,说明何时仍需人工处理。
已确认修复 (4019e28): 已复查原触发条件及从视觉指南和 PR 模板进入的调用路径:用例协作指南现把启用图文选择时的已保存修订更新,与未启用或无可用清单时的人工流程明确分开,并说明结果未知时不得另行手工重复写入;中英文模板和视觉指南也写明图文选择适用边界。原先会引导维护者对已自动处理的共享基准再走人工更新的无条件要求已消失。
VisActor 工作流结论:流程已完成。
请核对 BugServer 默认全选清单,改选后保存,再手动 Merge;Approve 可选,仅记录操作。 Photo 基准选择尚未保存;不影响三项检查建议或人工合入。 Photo 执行明细Photo 原始执行:completed;结果:passed;缺少基准 0;等待 0;运行中 0;不完整 0;创建未知 0。 Photo 差异解释(非阻断建议)差异共 0 项;已逐项分析 0 项;未分析 0 项。 图片差异解释(0 项)暂无已解释差异。 合入后 Photo 基准更新清单没有已授权的基准更新。 版本与合入后状态当前提交: 合入后状态:skipped。 CN 结果仅证明上述实际范围;完整报告和原始差异继续保留。 |
同步 Photo 图文选择的操作指引:新候选默认全选、改选须保存、Approve 仅作审计,人工 Merge 后仅处理已保存的所选基准。旧人工基准流程明确限定为未启用或无可用清单的情况,避免重复写入;GitHub 分支保护、原报告和未知请求恢复要求保持。
本 PR 作为 VBI 四仓扩展的精确验收目标,已转 Ready,按现有单重型调度执行。文档合入不代表全量开放,实际能力以维护者明确配置为准;Bot 不代为 Approve 或 Merge。
验证:
VisActor 工作流(CN):completed
当前提交:
4019e28ebd536bc492ac2fae91efcf0aca7d231c三项检查建议与 BugServer 人工确认